home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / Time_ToAscii.man < prev    next >
Encoding:
Text File  |  1990-11-30  |  2.6 KB  |  69 lines
  1.  
  2.  
  3.  
  4. Time_ToAscii          C Library Procedures           Time_ToAscii
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      Time_ToAscii, Time_FromAscii, Time_ToParts, Time_FromParts -
  12.      time conversion routines
  13.  
  14. SSYYNNOOPPSSIISS
  15.      ##iinncclluuddee <<sspprriitteeTTiimmee..hh>>
  16.  
  17.      TTiimmee__TTooAAsscciiii(_s_e_c_o_n_d_s, _i_s_I_n_t_e_r_v_a_l, _b_u_f_f_e_r_P_t_r)
  18.  
  19.      TTiimmee__FFrroommAAsscciiii(_b_u_f_f_e_r_P_t_r, _t_i_m_e_P_t_r)
  20.  
  21.      TTiimmee__TTooPPaarrttss(_s_e_c_o_n_d_s, _i_s_I_n_t_e_r_v_a_l, _p_a_r_t_s_P_t_r)
  22.  
  23.      TTiimmee__FFrroommPPaarrttss(_p_a_r_t_s_P_t_r, _i_s_I_n_t_e_r_v_a_l, _s_e_c_o_n_d_s_P_t_r)
  24.  
  25. AARRGGUUMMEENNTTSS
  26.      int       _s_e_c_o_n_d_s        (in)      A time value  in  seconds
  27.                                         to be converted to Ascii.
  28.  
  29.      Boolean   _i_s_I_n_t_e_r_v_a_l     (in)      If  TRUE,  interpret  the
  30.                                         time as a time interval.
  31.  
  32.      char      *_b_u_f_f_e_r_P_t_r     (out,in)  A buffer to hold the con-
  33.                                         verted time.
  34.  
  35.      Time      *_t_i_m_e_P_t_r       (out)     Buffer  to  hold  a  time
  36.                                         value    converted   from
  37.                                         Ascii.
  38.  
  39.      Time_Parts               _p_a_r_t_s_P_t_r(in/out)
  40.                                         Buffer  to  contain   the
  41.                                         decomposed time values.
  42.  
  43.      int       *_s_e_c_o_n_d_s_P_t_r    (out)     Place to store time value
  44.                                         converted from parts.
  45.  
  46.  
  47. _________________________________________________________________
  48.  
  49. DDEESSCCRRIIPPTTIIOONN
  50.      The TTiimmee__TTooAAsscciiii and  TTiimmee__FFrroommAAsscciiii  procedures  convert  a
  51.      time  value  in seconds to and from Ascii. TTiimmee__TTooPPaarrttss con-
  52.      verts a time value in seconds into the year, month,  day  of
  53.      year,  day  of  month,m  day  of  week,  hours, minutes, and
  54.      seconds. TTiimmee__FFrroommPPaarrttss converts a time value from its parts
  55.      to seconds.  Don't give it a date before January 1, 1970 and
  56.      make sure that the day of year corresponds to the month  and
  57.      day  of month values.  An interval is the difference between
  58.      two times.
  59.  
  60. KKEEYYWWOORRDDSS
  61.      ascii, time
  62.  
  63.  
  64.  
  65. Sprite v.1.0       Printed:  November 29, 1990                  1
  66.  
  67.  
  68.  
  69.